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In column 15, line 30, below "</html>" 
insert - - 

APPENDIX D 

A portion of an embodiment of the device tester 304 

//include <windovvs.h> 
#include <tchar.h> 
^include <$tdlib.h> 
^include <stdio.h> 
#include <setupapi.h> 
^include <cfgmgr32.h> 
^include <string.h> 
^include <malloc.h> 
^include <newdev.h> 

#define ARRAYSIZE(x) (sizeofi(x)/sizeof(x[0])) 

^define INSTANCETO_PREFIX_CHAR TEXTf®') // character used to prefix instance ID'S 

ffdefine CLASS^PREFIX J2HAR *■ TEXT('=') // character used to prefix class 

name 

^define WILD _CHAR TEXT('**) // wild character 

^define QUOTEJPREFIX_CHAR TEXT(T) // prefix character to ignore wild 
characters 
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int EnumcratcDeviceQ; 

inl removeDevice(char *devID); 

LPTSTR GetDeviceDescriptionfHDEVINFO Devs,PSPJDEVINFO_DATA Devlnfo); 

BOOL DumpDeviceDescr(?roEVINFO Devs 1 PSPJDEVTNFO_DATA Devlnfo); BOOL 
DumpDeviceStatus(HDEVINFO Dcvs,PSP_DEVINFO_DATA Devlnfo); BOOL 
DumpDevice Within foCHDEVrNFO Devs > PSP_DEVRvFFOJDATA DevInfo,LPCTSTR Info); 

#ifdef_UNICODE 

^define UPDATEDRIVERFORPLUGANDPL AY DEVICES 

,, UpdateDrive^ForP!ugAndPlayDevicesW r, 

#else 

^define UPDATEDRJVERFORPLUGANDPLAYDEVICES 

"UpdateDriverForPlugAndPlayDevicesA" 

tfendif 

// 

//exit codes 

// 

MefineEXIT_01t (0) 
#define EX1T_REBOOT (1) 
^define EXIT^ FAIL (2) 
^define EXITJJSAGE • (3) 
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typedef struct { 
DWORD count; 
DWORD control; 
BOOL reboot; 
LPCTSTR strSuccess; 
LPCTSTR strReboot; 
LPCTSTR strFail; 

} 

GenericContext; 

^define FIND ^DEVICE 0x00000001 // display device 
ffdefinc FINDIsTATUS 0x00000002 // display status of device 
^define FIND_RESOURCES 0x00000004 // display resources of device 
#define FINDJDRIVERS 0x00000008 // display drivers used by device 
^define FINDJHWIDS 0x00000010 // display hw/compat id's used by 



tfdefine FTND DRJVERNODES 0x00000020 // display driver nodes for a device, 

Devcoircpp 

^include "devcon.h" 
//include <string.h> 

FILE * stream; 
char *oulflle; 
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TCHAR 



szBufTcr [6000]; 



void EncodeXMLString( string szlnput, string& szOutput) 
{ 

string strBuffer; 
size t nFirstlndex; 
strBuffer = szlnput; 

nFirstlndex = strBufrer.findC r ( ,,:> ") 5 0); 
while (nFirstlndex != string: :npos) 
{ 

strBuffer = strBuffer.rep]ace(nFirsttndex, Jtcslen(jr(Vr)), _T(">")); 

nFirstlndex « strBuffer. findd^ 1 ^"), nFirstIndex+1); 

} 

nFirstlndex = strBuffer.findC_T( n<H ), 0); 
while (nFirstlndex !« stringr npos) 
{ 

strBuffer = strBuffer.replace(rvFirstIndex, ^tcslenCTO")). _T( M < M )); 

nFirstlndex = ■str'BufTer.find(lT("< ,, ) t nFirstlndex+l); 

} 

nFirstlndex = strBuffer. find(_T( ), 0); 
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while (nFirstlndex !=» string: :npos) 
{ 

strBuffer = strBuffer.replace(nFirstIndex, _tcslen(_T("l")), _T("&apos;")); 
nFirsilndcx = StrBuffer. find(_T( ), nFirst Index +1); 
} 

nFirstlndex = strBuffer. find(_T("\""), 0); 
while (nFirstlndex != string::npos) 

{ ' 

strBuffer = strBuffer. rep I ace< nFirstlndex, _tcs1en(_T(' , l 1, ))» _T(""")); 

nFirstlndex - strBuffer. findCT( M V"'), tiFirstlndex+l); 

} 

nFirstlndex = strBuffer. find (JTC&T), 0); 

while (nFirstlndex !~ string: :npos) 

{ 

if (nFirstlndex != strBuffer.nnd(_TC , & n ), nFirstlndex) <&& 
nFirstlndex != strButTer.find(_ r( M >"X nFirstlndex) SlSc 
nFirstlndex N strBuffer. find(_TC&1t;"X nFirstlndex) && 
nFirstlndex strBufferTind(_T( M &apos; M >, nFirstlndex) ScSc 
nFirstlndex !^ strBuffer, rindC_T( ,, " ,, ) t nFirstlndex)) 
{ 

strBuffer = strBufTer.replace(nFirstTndex, I , _T( 1, & r ')); 
\ 

nFirstlndex = strBuffer. ft nd(_T("&"), nFirstlndex^ I); 

} 

szOutput - strBuffer; 
} //EncodeXMLString 
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LPTSTR GetDeviceStringProperty(HDEVlNFO Devs,PSP_DEVINFO_DATA 

DevInfo,DWORD 

Prop) 

{ 

LPTSTR buffer; 
DWORD size; 
DWORD reqSize; 
DWORD dataType; 
DWORD szChars; 
size= 1024; 

buffer = new TCHAR[(size/sizeotrTCHAR))+l]; 
if(! buffer) 

{ 

return NULL; 

} 

while(!SctupDiGetDeviceRegistryProperty(Devs > DevInfoJProp,&dataType 1 (LPBYTE) 
buffer.size.&reqSize)) 
{ 

tfl(GctLastEiTor<) != ERROR JNSUFFICIENT_BUFFER) { 
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goto failed; 

} 

iffdataType != REG_SZ) { 
goto failed; 

} 

size = reqSize; 
delete [] buffer; 

buffer = new TCHAR[(size/sizeo^TCHAR))+l ); 
iftlbuffer) { 
goto failed; 

} 

} 

szChars - rcqSize/sizeof(TCHAR); 
buffer[szChars] = TEXT('\0'); 
return buffer; 
failed: 

iflbuffer) { 

delete [] buffer; 

} 

return NULL; 

> 
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LPTSTR GelDeviceDescription(HDEVINFO Devs,PSP J>EVINFO_DATA Devlnfo) { 
LPTSTR desc; 

desc = GetDeviceStringI^pcrty(Devs»De^ 
tf(!desc) { 

desc = GetDeviceStringPropertyO^cvs.DevInfcSPDRP^DEVICEDESC); 

} 

return desc; 

} 

void rep!aceStr(char *Str,char *newDevId, char ch) 

{ 

char* word; 

word = strtok(Str 1 M & M ); 

strcpy(newDevId,\vord); 

while(wordNNULL) 

{ 

word - strtok(NULL, n &"); 
i f( word=NULL) break; 
strcat(newDcvId,"& M ); 
strcal(newDev!d,word); 

} 

return; 

> 
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BOOL DumpDeviceWithInfo(HDEVINFO Devs,PSP_DEVINFO_DATA DevInfo.LPCTSTR 
Info) { . 

TCHAR devID[MAX_DEVICE_ID_LEN]; 
BOOL b = TRUE; 

SP_DEVlNFO_LIST_DETAlL_DATA dcvInfoListDetail; 
devInfoListDetail.cbSize = sizeot^devInfoLislDelail); 
i f(CM_Gel_Device_ID(DevInfo- 

>DevInst,devID,MAX DEVICE_rD_LEN,0)!=CR_SUCCESS) 

{ 

lstrcpy(devID,TEXTH")); 
b = FALSE; 

} 

string szDevID^devID; 
string szOutputDevId; 

EncodcXMLString(sxDevID,szOutputDevId); 
prinlfl[ n \n%s M ,szOutputDevIdx^str()); 

return b; 

} 
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BOOL DumpDeviceDescr(HDEVINFO Dcvs.PSP _J>EVlNFO_DATA Devlnfo) 
{ 

LPTSTR desc; 

const int iStringMaximumLcnglh c = 8048; 

WCHAR szwBigBufTertiStringMaximumLcngth_c]; 

const int iMaxEight c = 10096; 

CHAR szBigBufTer[iMaxEight_c]; 
desc = GetDeviceDescriplion(Devs,DevInfo); 
if(fdcsc) { 

printfl[ M \nDevice Description is not available for this device"); 
return FALSE; 

> 

MultiByteToWideChar(CP_ACP, 0, desc, - 1 , szwBigBufTer, 
si zeo f^szwB igBu ffer)); 

WideCharToMuitiByte(CP_UTF8, 0, szwB igBu ffer, - 1 , szB igBu ffer, 
sizcoftszBigBuffer), NULL, NULL); 
fprintr(stream/'\n\t\t<DeviceDesc^ 
Her); 

printf("\n%s N ,dcsc); 
delete [] desc; 

return TRUE; 1 

J 

BOOL DumpDeviceStatus(HDEVINFO Devs,PSP DEVINFO DATA Devlnfo) 

{ 

SP_DEVTNFO_LIST_DETAIL_DATA devlnfo ListDetail; 
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ULONG status = 0; 
ULONG problem =0; 
BOOL haslnfo - FALSE; 

CMAPI CONF1GRET WTNAPI CM JDet _DevNode_Status(OUT PULONG 
pulStatus,OUT PULONG pulProblemNumber.lN DEVINST dnDcvInstJN ULONG ulFIags ); * 

devlnfoListDetail.cbSize - sizeof(devlnfoLisiDetail); 
ir(CM^Get^DcvNodc^Status(&status,&problem,DevInfo->DevInst,0)!=CR^SUCCESS) 
{ 

return FALSE; 

> 

printf( n \rtError Code : %i",problem); 

fpnntf(streajri/ , \n\t\t<EiTorCode>%i<^£TTorCode>",problem); 
ifftstatus & DN HAS^PROBLEM) && problem — CM PROB DISABLED) 
{ 

haslnfo = TRUE; 

printr("\n%s , \ H Dcvice is disabled"); 

fprintftstream, H \nM\t<Status>V , %sV , </Status>"/ , Device is disabled"); 
return TRUE; 

> 

i ({status & DN_HAS_PROBLEM) 
{ 

haslnfo = TRUE; 

printf( M \n%sV Device has a problem"); 

fprintf(stream/ , \n\t\t<Status>\ M %sV'</Status>","Device has a problem"); 

> 

if(status & DNPRIV ATE JP ROB LEM) 
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{ 

haslnfo = TRUE; 

printfl[ ,l \n%s", H Dcvice has a problem reported by the driver"); 

fprintf(stream f n \n\t\t<Status>\ M %s\ u </Status> ,, , ,, Device has a problem reported by 

the driver"); 
} 

ifi[status&DN STARTED) 
{ 

printfT\n%sVDevice has been started"); 

fprintf(stream, M \n\t\t<Status>\"%sV , </Status> ,, , M Device has been started"); 

} 

else if (lhaslnfo) 
{ 

fprintll[stream, ,, \ii\t\t<Status>\"%sV , <yStatus> M , M Device is currently stopped"); 
printfC'VriDevice is currently stopped"); 

} 

return TRUE; 

} 

int GetDeviceInfoAndDelcte(char * devIDtoDelete) 
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{ 

HDEVINFO devs - INVALID_HANDLE_VALUE; 
DWORD err; 

int failcode = EX1T_FA1L; 
DWORD devlndex; 
SP_DEYINFO_DATA devlnfo; 

SP_DEVINFO_LIST_DETAIL_DATA devInfoListDctail; 
BOOL matchFound = FALSE; 
SP_REMOVEDEVlCE_P ARAMS rmdParams; 
LPCTSTR action = NOLL; 
TCHAR devID[MAX_DEVICE_£D_LEN]; 

devlnfoLislDetail.cbSize = sizeof(devInfoListDetail); 

printf("Device to be deleted is %$", devlDtoDelete); 
devs = SetupDiGetClassDcvs( 
NULL,NULL,NULL,D1GCF_ALLCLASSES|DIGCF_PRESENT); 

if^devs — INVALLD_HANDLE_VALUE) 

{ 

err = GetLastErrorO; 

printf( "SetupDiGetClassDevs failed: %lx.\n", err ); 

failcode=EXIT_FA!L; 

goto final; 

} 
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devlnfoListDetaihRemoteMachineHandle = NULL; 

strcpy(dev In foLi stDelai 1. RemoteMachineNarae,""); 
devInfoListDetail.cbSize = sizeoffdevlnfoListDetail); 

devinfoListDetailxbSize - sizeof][SP_DEVlNFO_LIST_DETAIL_DATA); 
devInfoxbSize - stzeofl[devlnfo); 
for(devlndex=0;SetiipDiEnun^ 

{ 

if(CM^etJDevice^ro(dev^^^^ 
{ 

lstrcpy(devID,TEXT("?")); 

} 

printf( M Dev ID for comparison is : %s \n M ,devCD); 
i f(strcmp(devID s devIDtoDelete)==0) 

{ 

printfC'Nn match found'*); 
matchFound = TRUE; 
rni dParams . CI asslnst ai IHeader . cbS i zc - 
sizeofl(SP_CLASSINSTALL_HEADER); 

rmdParams.ClassInstallHeader.InstaliFunction ~ 

DIF^ REMOVE; 

rrndParams.Scope = DI_REMOVEDEVrCE_GLOBAL; 
rmdParams.HwProfile = 0; 
ift!SenipDiSelC!assInstallParanis(devsA 

,sizeofi;rmdParams)) IIISetupDiCailCiasslnstallertDlF^REMOVE^evs^devInfo)) 
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{ 

fai lcode - EX1T FA1L; 
goto final; 

} 

printf("\n\ii Device has been deleted"); 
break; 

} 

} 

// The device was deleted ! ! 
if(rnalchFound = FALSE) 
{ 

printff'VnNn No matching device id found!!"); 
fai lcode - EXITJF AJL; 

> 

else 
{ 

failcode = EXIT JDK; 

I 

final: 

if(dcvs !« INVAL1D_HANDLE_VALUE) { 

print "destoryi n g Devsln foLi St"); 
SetupDiDestroyDeviccInfoList(devs); 

printff" After destorying DevsInfoList"); 

} 

return fai lcode; 

> 
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int EnumerateDevice() 

{ 

HDEVINFO devs - INVALID^HANDLE^VALUE; 
DWORD err; 

int failcode - EXTTJFAIL; 
DWORD devlndex; 
SPJDEVINFO_DATA devlnfo; 

SP_DEVINFO_LIST_DETAIL_DATA devInfoListDetail; 
DWORD numClass — 0; 
int skip = 0; 

devs = SetupDiGetCIassDeys( 
NULL t NULL T NULL T DIGCF_ALLCLASSESpIGCF PRESENT); 

//devs = SetupDiGetClassDevs( 
NTULUMJLL^NULL.DIGCFALLCLASS 

if(devs — rNVALlD_HANDLE_VALUE) 

{ 

err = GetLastError(); 

prtntft "SetupDiGetClassDevsEx failed: %lx.W\ err ); 
failcode= EXIT_FAIL; 
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goto final; . 

} 

devInfoListDetail.RemoteMachineHandle = NULL; 

strcpy(devlnfoListDetail.RemoteMachineName,""); 
devlnfoListDetail.cbSize = sizeof^devInfoListDetail); 

devInfoListDetail.cbSize = sizeofl(SP_DEV]NFO_LIST_DETAIL_DATA); 
devInfo.cbSize = sizeofljdevlnfo); 

for(devbidex=0;SetupDiEnumDevicclhfo(dcvs,devIndex,&devInfo);devlndex+-*') 

( 

TCHAR devJD[MAX_DEVlCE_ID_LEN]; 
if(CMj3ctJ3eviceJD(^^ 
{ 

IstTcpy(devID > TEXT( M ? ,, )); 

} 

// printf( M Dev ID for comparison is : %s \n",devlD); 

printfC\n\n M ); 

fprintf(stTeam/'\n\t<Device> n ); 

ifXIDumpDeviceWithlnfofdevs^devlnfo.NULL)) reiurn EX1TJ3K; 
DumpDeviceDcscr(devs,&dcvInfo); 

DumpDeviceStatus(devs»&devInfo); 
fprintf(st^eam; , \n\t</Device> ,, ); 
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} 

failcode-EXIT_OK; 
final: x 

if(devs != fNVALID_HANDLE_VALUE) { 
SetupDiDestroyDevicelnfoList(devs); 

} 

return failcode; 

int rcmoveDevice(char *devID) 
( 

printf( M %s'\dcvID); 

return GetDevicelnfoAndDelete(devID); 

} 

int 1istDeviceStatus() 
{ 

int result; 

if(outflle!-KULL) 
{ 

stream = fopenfoutflle, M w M ); 

} 

else 
< 

stream - fopen("devlist.xml'\ "w" ); 
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} 

fprintf(stream, M <DeviceManager> <, )r; 
result - EnumerateDevice(); 

fprintf(stream, u \n</DcviceManager>"); 
fclosc( stream ); 
return result; 

} 

void writeReturnCode(int code) 
{ 

FILE *Ostream; 

Ostream = fopen( "DMStatusouf, "w" ); 
fpri n tf(Ostream , "%i " ,cod e) ; 
fclose(Ostream); 

} 

void main(int argc,LPTSTR argv[]) 
{ 

int retval; 
ifl(argc<2) 
( 
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printf("Wrong arguments"); 

writeRetumCode(3); 

exil(3); 

} 

i f(strcmp(argv[ 1 ],"remove")=0) 
I 

//Check if the id is specified 

printfX M calling remove device %s w , argv[2]); 

if*argv[2]==NULL) 

{ 

/ print ^'Missing device id"); 

writeReturnCode(3); 
exit(3), 

} 

retval = removeDevicc(argv[2]); 

writeRetumCode(retval); 

exit(retval); 

} 

if(strcmp(argv[ 1 ]/'status*')=0) 
{ 

// if the out file name is specified 

ifl[argc=3) 

{ 

outflle =argv[2]; 

} 
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UNITED STATES PATENT AND TRADEMARK OFFICE 

CERTIFICATE OF CORRECTION 

Page 21 of 21 

PATENT NO : 7,325,170 

APPLICATION NO. : 10/804,290 

ISSUE DATE : Jan. 29, 2008 

INVENTOR(S) : Karamadai Srinivasan, et al. 

It is certified that an error appears or errors appear in the above-identified patent and 
that said Letters Patent is hereby corrected as shown below: 

printf("CaIling status"); 
retval » listDeviceStatusQ; 
writeReturnCode(retval); 
cxit(retval); 

} 

writeReturnCode(2); 
exit<2); 

} 



In column 16, line 2, in Claim 3, delete "Suitable" and insert - - suitable - -, therefor. 
In column 16, line 52, in Claim 9, delete "deivce" and insert - - device - -, therefor. 
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